LGF_ExtractStringFromCharArrayAdv (FC / 1.1.0)

Autor: Siemens Online Support

Kurzbeschreibung

Extrahiert eine Zeichenkette, die durch einen Text davor und danach angegeben ist, aus einer Reihe von Zeichen mit erweiterten Optionen.

Baustein Schnittstelle

		LGF_ExtractStringFromCharArrayAdv (FC)
String			textBefore		Ret_Val			Word
String			textBefore		Ret_Val			Word
String			textAfter		extractedString			String
String			textAfter		extractedString			String
Bool			includeBeforeAfter		position			DInt
Bool			includeBeforeAfter		position			DInt
DInt			startPos		length			Int
DInt			startPos		length			Int
					status			Word
					status			Word
Variant			searchIn					Variant
Variant								Variant

Input Parameter

Bezeichner	Datentyp	Beschreibung
textBefore	String	Text vor den Zeichen, die extrahiert werden sollen
textAfter	String	Text hinter den Zeichen, der extrahiert werden muss
includeBeforeAfter	Bool	TRUE: `TextBefore` und `TextAfter` sind in der extrahierten Zeichenkette enthalten
startPos	DInt	Position innerhalb des Arrays ab der die Suche beginnen soll (Index null basiert)

Output Parameter

Bezeichner	Datentyp	Beschreibung
Ret_Val	Word	Rückgabewert: 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
extractedString	String	Extrahierte Zeichenkette
position	DInt	Position (Index) innerhalb des Arrays, an der der Text beginnt (Index null basiert)
length	Int	Länge des Textes, der extrahiert wurde
status	Word	16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

In/Out Parameter

Bezeichner	Datentyp	Beschreibung
searchIn	Variant	Array von Character oder Byte in dem gesucht wird.

Status & Error Meldungen

Code / Wert	Bezeichner / Beschreibung
16#0000	STATUS_TEXT_FOUND Erfolgreich, Starttext und Endtext wurden gefunden
16#0000	STATUS_NO_ERROR Status: Abarbeitung ohne Fehler beendet
16#8200	ERR_NO_ARRAY Fehler: Am Eingang `searchIn` liegt kein Array von Character oder Byte an.
16#9001	WARNING_ONLY_START Nicht erfolgreich, nur der Anfangstext wurde gefunden, der extrahierte String ist mit Zeichen nach dem Anfangstext gefüllt
16#9002	WARNING_NOTHING_FOUND Erfolglos, kein Text wurde gefunden

Änderungshistorie

Version & Datum		Änderungsbeschreibung
	1.0.0	Siemens Online Support
	01.04.2019	First released version (LHttp)
	1.1.0	Siemens Online Support
	10.06.2022	Adaption and integration into LGF